---
title: Polymarket
description: 访问 Polymarket 的预测市场数据
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="polymarket"
  color="#4C82FB"
/>

{/* MANUAL-CONTENT-START:intro */}
[Polymarket](https://polymarket.com) 是一个去中心化的预测市场平台，用户可以利用区块链技术交易未来事件的结果。Polymarket 提供了一个全面的 API，使开发者和代理能够访问实时市场数据、事件列表、价格信息和订单簿统计数据，以支持数据驱动的工作流和 AI 自动化。

通过 Polymarket 的 API 和 Sim 集成，您可以让代理以编程方式检索预测市场信息，探索开放市场及相关事件，分析历史价格数据，并访问订单簿和市场中点。这为研究、自动化分析以及开发能够根据市场价格得出的实时事件概率做出反应的智能代理创造了新的可能性。

Polymarket 集成的主要功能包括：

- **市场列表与筛选：** 列出所有当前或历史预测市场，可按标签筛选、排序并分页查看结果。
- **市场详情：** 通过市场 ID 或 slug 检索单个市场的详细信息，包括其结果和状态。
- **事件列表：** 访问 Polymarket 事件列表及详细事件信息。
- **订单簿与价格数据：** 分析订单簿，获取最新市场价格，查看中点，或获取任何市场的历史价格信息。
- **自动化准备：** 构建能够以编程方式对市场动态、赔率变化或特定事件结果做出反应的代理或工具。

通过使用这些文档化的 API 端点，您可以将 Polymarket 丰富的链上预测市场数据无缝集成到您自己的 AI 工作流、仪表盘、研究工具和交易自动化中。
{/* MANUAL-CONTENT-END */}

## 使用说明

将 Polymarket 预测市场集成到工作流程中。可以获取市场、单个市场、事件、单个事件、标签、系列、订单簿、价格、中点、价格历史、最后交易价格、价差、最小变动单位、持仓、交易以及搜索功能。

## 工具

### `polymarket_get_markets`

从 Polymarket 检索预测市场列表，并可选择进行筛选

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `closed` | string | 否 | 按关闭状态筛选 \(true/false\)。使用 false 仅显示活跃市场。 |
| `order` | string | 否 | 排序字段 \(例如：volumeNum, liquidityNum, startDate, endDate, createdAt\) |
| `ascending` | string | 否 | 排序方向 \(true 表示升序，false 表示降序\) |
| `tagId` | string | 否 | 按标签 ID 筛选 |
| `limit` | string | 否 | 每页结果数量 \(推荐：25-50\) |
| `offset` | string | 否 | 分页偏移量 \(跳过此数量的结果\) |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | 布尔值 | 操作成功状态 |
| `output` | 对象 | 市场数据和元数据 |

### `polymarket_get_market`

通过 ID 或 slug 检索特定预测市场的详细信息

#### 输入

| 参数 | 类型 | 是否必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `marketId` | 字符串 | 否 | 市场 ID。如果未提供 slug，则必需。 |
| `slug` | 字符串 | 否 | 市场 slug \(例如，"will-trump-win"\)。如果未提供 marketId，则必需。 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | boolean | 操作成功状态 |
| `output` | object | 市场数据和元数据 |

### `polymarket_get_events`

从 Polymarket 检索事件列表，可选过滤

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `closed` | string | 否 | 按关闭状态筛选 \(true/false\)。使用 false 仅显示活跃事件。 |
| `order` | string | 否 | 排序字段 \(例如：volume, liquidity, startDate, endDate, createdAt\) |
| `ascending` | string | 否 | 排序方向 \(true 表示升序，false 表示降序\) |
| `tagId` | string | 否 | 按标签 ID 筛选 |
| `limit` | string | 否 | 每页结果数量 \(推荐：25-50\) |
| `offset` | string | 否 | 分页偏移量 \(跳过此数量的结果\) |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | boolean | 操作成功状态 |
| `output` | object | 事件数据和元数据 |

### `polymarket_get_event`

通过 ID 或 slug 检索特定事件的详细信息

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `eventId` | string | 否 | 事件 ID。如果未提供 slug，则必需。 |
| `slug` | string | 否 | 事件 slug \(例如，"2024-presidential-election"\)。如果未提供 eventId，则必需。 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | boolean | 操作成功状态 |
| `output` | object | 事件数据和元数据 |

### `polymarket_get_tags`

从 Polymarket 获取用于筛选市场的可用标签

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `limit` | string | 否 | 每页结果数量 \(推荐：25-50\) |
| `offset` | string | 否 | 分页偏移量 \(跳过此数量的结果\) |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | boolean | 操作成功状态 |
| `output` | object | 标签数据和元数据 |

### `polymarket_search`

在 Polymarket 上搜索市场、事件和个人资料

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `query` | string | 是 | 搜索查询词 |
| `limit` | string | 否 | 每页结果数量 \(推荐：25-50\) |
| `offset` | string | 否 | 分页偏移量 \(跳过此数量的结果\) |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | boolean | 操作成功状态 |
| `output` | object | 搜索结果和元数据 |

### `polymarket_get_series`

从 Polymarket 获取系列（相关市场组）

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `limit` | string | 否 | 每页结果数量 \(推荐：25-50\) |
| `offset` | string | 否 | 分页偏移量 \(跳过此数量的结果\) |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | boolean | 操作成功状态 |
| `output` | object | 系列数据和元数据 |

### `polymarket_get_series_by_id`

通过 ID 从 Polymarket 检索特定系列（相关市场组）

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `seriesId` | string | 是 | 系列 ID |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | boolean | 操作成功状态 |
| `output` | object | 系列数据和元数据 |

### `polymarket_get_orderbook`

检索特定代币的订单簿摘要

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `tokenId` | string | 是 | CLOB 代币 ID \(来自市场 clobTokenIds\) |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | boolean | 操作成功状态 |
| `output` | object | 订单簿数据和元数据 |

### `polymarket_get_price`

检索特定代币和方向的市场价格

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `tokenId` | string | 是 | CLOB 代币 ID \(来自市场 clobTokenIds\) |
| `side` | string | 是 | 订单方向：买或卖 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | boolean | 操作成功状态 |
| `output` | object | 价格数据和元数据 |

### `polymarket_get_midpoint`

检索特定代币的中间价

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `tokenId` | string | 是 | CLOB 代币 ID \(来自市场 clobTokenIds\) |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | boolean | 操作成功状态 |
| `output` | object | 中间价格数据和元数据 |

### `polymarket_get_price_history`

检索特定市场代币的历史价格数据

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `tokenId` | string | 是 | CLOB 代币 ID \(来自市场 clobTokenIds\) |
| `interval` | string | 否 | 截止到当前时间的持续时间 \(1m, 1h, 6h, 1d, 1w, max\)。与 startTs/endTs 互斥。 |
| `fidelity` | number | 否 | 数据分辨率（以分钟为单位）\(例如，60 表示每小时\) |
| `startTs` | number | 否 | 开始时间戳 \(Unix 秒 UTC\) |
| `endTs` | number | 否 | 结束时间戳 \(Unix 秒 UTC\) |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | boolean | 操作成功状态 |
| `output` | object | 价格历史数据和元数据 |

### `polymarket_get_last_trade_price`

检索特定代币的最新交易价格

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `tokenId` | string | 是 | CLOB 代币 ID \(来自市场 clobTokenIds\) |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | boolean | 操作成功状态 |
| `output` | object | 最新交易价格和元数据 |

### `polymarket_get_spread`

检索特定代币的买卖价差

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `tokenId` | string | 是 | CLOB 代币 ID \(来自市场 clobTokenIds\) |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | boolean | 操作成功状态 |
| `output` | object | 价差数据和元数据 |

### `polymarket_get_tick_size`

检索特定代币的最小跳动单位

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `tokenId` | string | 是 | CLOB 代币 ID \(来自市场 clobTokenIds\) |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | boolean | 操作成功状态 |
| `output` | object | 跳动单位和元数据 |

### `polymarket_get_positions`

从 Polymarket 检索用户持仓

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `user` | string | 是 | 用户钱包地址 |
| `market` | string | 否 | 可选的市场 ID，用于筛选持仓 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | boolean | 操作成功状态 |
| `output` | object | 持仓数据和元数据 |

### `polymarket_get_trades`

从 Polymarket 获取交易历史

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `user` | string | 否 | 用户钱包地址，用于筛选交易 |
| `market` | string | 否 | 市场 ID，用于筛选交易 |
| `limit` | string | 否 | 每页结果数量（推荐：25-50） |
| `offset` | string | 否 | 分页偏移量（跳过此数量的结果） |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `success` | boolean | 操作成功状态 |
| `output` | object | 交易数据和元数据 |

## 注意事项

- 类别: `tools`
- 类型: `polymarket`
